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1 Compatibility 

The following list of known problems and omissions applies to the OCCam 2 
toolsets IMS D7205A. IMS D5205A, and IMS D4205A. 

The tools within it (where applicable) supersede those provided with the ANSI 
C toolsets Dx214A and D7214B. This is important if you are performing mixed 
language programming with both toolsets resident at the same time; this toolset 
and the tools and libraries within It should be used in preference to those in the 
above ANSI C toolsets. 



2 Potential language change 

The following section highlights an area of Occam which may be subject to an 
implementation restriction in future toolset releases. 

The length provided in a counted array protocol shou\(i not appear on the array 
side of the communication. 

For instance, the following counted array protocol example: 

c ? length:: [buffer FROM FOR length] 

should be re-written with the equivalent line: 
c ? length: : buffer 
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3 Toolset errata 

3.1 General 

« The iserver used with this toolset can handle a maximum packet 
length of 1024 bytes. However, the Occam Library has a maximum 
packet length of 512 bytes. This may lead to errors if the iserver 
should send a packet longer than 512 bytes to either an application or 
one of the tools in this toolset. This would only occur in extreme sit- 
uations, such as using the getenv function to obtain an environment 
variable which is longer than 509 characters. This bug will be fixed in 
future releases of iserver. 

(0239) 

• Due to a minor problem in this release with the usage of TCOFF repre- 
sentation of processor capabilities between tools (eg. hardware break- 
point support, FPU etc.), a problem arises when collecting some single 
processor programs with icollect when using the 't' option. 

This problem does NOT affect the bootable code produced by the toolset. 

The problem manifests itself by making transputer types appear to mi- 
grate to another processor type between different tools: 

Original type Migrated type 

T222 -> T212 
T400 -> T425 

T801 --> Ta05 

This is best illustrated by an example: 

eg. 

OG foo,occ /t400 

ilink foo.tco hostio.lib /f occaroa.lnk /t400 

icollect foo.lku /t 

ilist will show the processor type as T425 in both foo.tco and 
f oo . iku. More importantly, idebug will generate a serious error mes- 
sage when breakpoint debugging because it has been told to expect a 
T425 (and it finds a T400). When post-mortem debugging, idebug will 
generate a warning. 

Workaround 
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These problems primarily affect debugging where it is crucial that the 
transputer type used is the same as that specified in the configuration. 

One solution is to configure for a single processor with occonf (ie. don't 
use the icollect single processor 'T' option). 

If you must have single processor capability from icollect, the fol- 
lowing table illustrates individual workarounds for the different processor 

types: 



Processor 
Type 



T222 

T400 

T801 



Workaround (for icollect T option) 



none " idebug will happily think the processor is a T212. 
debug inTB(orTA) mode and commit to T400 mode when 
debugged. 

debug in TA mode and commit to T801 mode when de- 
bugged. 



(0539) 

fc The driver programs for the transputer hosted tools (except idebug and 
idump) monitor the error flag as the tool executes in order to catch any 
internal errors of the tool should they occur. If your hardware is configured 
as a down system and consists of more than one transputer, then the 
driver programs may be fooled into thinking the tool has set the error flag 
if the error flag on one of the extra processors is already set when the 
tool starts. In order to overcome the problem, you should run ispy, a 
network check program (or similar), or boot a dummy program that uses 
all the transputer processors in the network. 

Note that, once cleared, the error flag on a transputer will only become 
set again if you execute an erroneous program on the transputer, or if 
you power off the transputers. The state of the error flag is undefined 
(hence it may be set) when the power is turned on. 

(0555) 

• The following error message can be set by any of the PC hosted tools. 

Runtime error R6000 - stack overflow 

This is a general error message that can occur using ANY of the tools. 
The message is generated at njntime by the Microsoft C aintime system 
and cannot be trapped by the tool. Wori^ around by running the tool on 
a transputer. 



(0680) 
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In rare circumstances, the following error message (or variations of it with 
the tool name <inmo3 library>) can be produced by some tools. 

Fatal-<inmos library>-low level write failed 2 

Such an error can occur for instance, if the disk fills up during the writing 
of a file {although the tool itself will normally notice this and report the 
error in more detail). 



(1180) 
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• ASSERT with INLINE test 

If the argument to ASSERT includes an inline function call which 
expands to a constant, then the assertion is not tested at all (either at 
compile time or at njn-time). 

(1179) 

• Running the compiler on different hosts can cause benign changes in 
the object code produced. These do not affect code behaviour, but can 
change code size. 

(1195) 

« Counted array protocol 

When compiling code in stop mode, oc may generate code which fails 
to detect invalid commumcation lengths (ie. lengths which are not com- 
patible with the size of the array being used in the communication). 

(1202) 

3.3 llink 

• ilink does not detect I/O en-ors when writing files. Thus, if a disk is 
full, it appears to run normally although no file is created, nor diagnostic 
given. 

(0623) 

3.4 [collect 

• There is a bug in icollect, using the 'T' option, whereby it informs 
72TDS282 00 March 12. 1991 



idebug that the type of a TSOl or T805 transputer is a T800. This will 
cause idebug to generate a serious error when breakpoint debugging, 
or a warning when post-mortem debugging. 

Note that this is a different bug to that mentioned in section 3.1. 

vyorka round 

Either use occonf to configure the program, or debug in TA mode. 

(0540) 

• D7205 (PC hosted version) only 

Us© o1 the icollect 'M" option to specify a memory size for non- 
configured programs does not wori< if you use a trailing M character to 
specify a. Megabyte (eg. 1M). 

Wsrk^ro.U.Q.!^. 

Either us© the transputer version of icollect instead of the PC hosted 
version or specify the memory size in Kilobytes (eg. 1024K instead of 
1M). 

(1192) 

• D7205 (PC hosted version) only 

Use of icollect to build a bootfile for a boot-from-rom system fails 
with the collector complaining that it cannot find the system libraries. 

WQr[<arQund 

Use the transputer version of icollect instead of the PC hosted ver- 
sion when building boot-from-rom bootfiles, 

(1193) 

• D7205 (PC hosted version) only 

Use of the icollect 'K' option with a T800 , iku file incorrectly creates 
a .rsc file for a T425 instead of a T600. 

Worl<around 

Use the transputer version of icollect instead of the PC hosted ver- 
sion. 
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(1199) 

3.5 Imaket 

• imakef does not specify the name for a .cfb file generated by 
icollect when generating a .bxx file using the 'T' option. This is 
only a problem if you create multiple ,bxx bootables for different trans- 
puter types from the same source in the same directory. 

Workaround 

Rename the , cfb file after creating each .bxx. 

(0529) 

• imakef displays incorrect version date: it displays the year 1 990 instead 
of 1991 when displaying its version string. 

(1177) 

• Using imakef to build a makefite for a class (eg. TA, TB) with the 
command line 'Y' option fails for non-configured programs (those built 
using the icollect 'T' option). This is because it passes the *Y' option 
to icollect which cannot use the 'Y' option in the presence of a class. 

Workaround 

Edit the makefile produced by imakef and remove the *Y' option from 
the $ (COLLECT) line. 

(1186) 

• D7205 (PC hosted vers[on) only 

If a makefile already exists, imakef will crash the PC when attempting 
to create a new version of the makefile. 

Workaround 

Either use the transputer version of imakef Instead of the PC hosted 
version or delete the makefile before running imakef. 

(1204) 

3.6 Isim 

• isim does not perform a long shift if the shift value is not in the range 
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< N < 64. Ratherlhan placing in both the A and B registers, it leaves 
them with their original values. 

(1109) 

9 isim and ALTWT. 

When a low priority process causes a high priority process waiting in 
an ALTWT instruction (part of an OCCam ALT) to be rescheduled, the 
simulator incorrectly provides the high priority process with a workspace 
pointer of MOSTNEG tNT (NotProcess.p). This causes the high priority 
process to incorrectly restart and the program to incorrectly execute. 

(1194) 

3,7 Examples 

« oc examples 

The example bSmath.occ Incorrectly includes a PC DOS path in a 
#DSE statement 

#aSE "m: \tcistools\libs\streamco . lib" 
It Should be changed to read: 

#USE "streamco.lib" 
In addition, the following line should be added at the top of b6math . occ: 

#0PTI0N "H" 

(0893) 

• mixconf examples 

The folJowing makefiles in do not have TABS in them and consequently 
they will fail fof those make utilities which require TABS: 

mixedl .mak 
inixed2 , mak 
znixedS ,mak 

(0892) 
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3.8 F editor 

• D7205 (NEC PC version) only 

The following files incorrectly refer to TDS files. 

\d7205\f \data\tds3)ceys , Id 
\d7205\f \data\do5keys . Id 

They should contain: 

tds33ceys . Id: L\d7205\f \data\tds3keys .tbl 
doskeya,ld: L\d720S\f\data\dos)ceys.tbl 

respectively. 

(0884) 

• II one of the file write operations from an exitall operation falls (eg. 
write permission denied) and the first such write has succeeded, F will 
loop forever If you were editing muitipEe files simultaneously. 

(0888) 

• En-or in Sun help file sunfold.hlp 

The Page down key In the INVERSE MAPPING section should read: 

Page down 
Esc Kpad Enter 

3.9 TDS support tools 

• Command line options 

The following TDS support tools have different command line character- 
istics to that provided by other toolset tools: 

iflat 
iflist 
i direct 

All three tools require that any command line option must appear after 
all other parameters. 

In addition, iflat and iflist have the following requirements: 
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iflat 

The PC hosted version requires the option switchchar to be 7", 
all other versions require it to be '-'. 

iflist 

All versions accept either V or '-' as the switchchar. 

(0890) 

4 Documentation omissions 

• User manual Part 1, p339 

The documentation for ieprom does not include the *R' option. 

The ieprom 'R' option causes iepromto print out the absolute address 
of the code reference point. This address is intended to be used in 
conjunction with the icollect 'P' option (produce memory map). 

(1170) 

» User manual Part 1, p339 

The documentation for ieprom does not state dearly enough the pro- 
cessor type to choose for all transputer variants. 

The following list states the type to use with ieprom: 

transputer type ieprom transputer type 



M212 


-> T2 


T212 


-> T2 


T222 


-> T2 


T225 


-> T2 


T400 


-> T4 


T414 


-> T4 


T425 


-> T4 


T800 


-> T8 


T801 


-> T8 


T805 


-> T8 


(1173) 




• User manual Part 2, 


Appendix A, p157 
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All the names used for the Occam configuration language have been 
missed off the list of predefined names in Appendix A of the manual. 

The ASM pseudo instructions are also missing. 

The description at the beginning of the Appendix groups names into vari- 
ous classes. The missing names of course do not fit the existing classes, 
therefore the following class names have been defined: 

1 Configurer keyword Keyv^^ord defined by the current configurer 
implementation. 

2 Configurer predefine. A name which is predeclared by the con- 
figurer. 

3 Configurer attribute. Configuration attribute defined in the cun-ent 
configurer implementation. 

4 Assembler directives. A name which is specially recognised by 
the compiler inside an asm constnjct. 

The missing names are as follows: 
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Name 


Class 


Library 


Notes 


ARC 

CONFIG 

CONNECT 

DO 

EDGE 

MAP 

MAPPING 

NETWORK 

NODE 

ON 

ONTO 

SET 

TO 

WITH 


configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 
configurer keyword 






link 

memsizd 

order . code 

order . vs 

root 

rootsize 

type 


configurer attribute 
configurer attribute 
configurer attribute 
configurer attribute 
configurer attribute 
configurer attribute 
configurer attribute 






HOST 


configurer predefine 






ADDRESSOF 

BYTE 

LD 

LDAB 

LDABC 

LDXABELDIFF 

ST 

STAB 

STABC 

WORD 


assembler directive 
assembler directive 
assembler directive 
assembler directive 
assembler directive 
assembler directive 
assembler directive 
assembler directive 
assembler directive 
assembler directive 







(1201) 
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SOFTWARE PROBLEM REPORT 



This form should be used to report a problem with INMOS software to Software Support, INMOS Busirtess 
Centre, SGS-THOMSON Microelectronics at one of the following addresses: 



Asia/Pacific 

France 

Germany 

Italy 

Japan 

Scandanavia 

UK 

USA 



28 Ang Mo Kio Industrial Park 2. Singapore 2056. 

7 Avenue Gallieni, BP 93. 94253 Gentiily Cedex. 

Bretonischer Ring 4, 8011 Grasbrunn, Munchen. 

V.le Milanofiori, Strada 4, Palazzo A/4/A, 20O90 Assago (Ml). 

Nisseki Takanawa Building, 4th Floor, 18-10 Takanawa2-chome, Minato-ku, Tokyo 108. 

Borgarfjordsgaten, 13 Box 1094, S-16421 KIsta, Sweden. 

Planar House, Parkway Globe Park. Marlow, Bucks SL7 1YL. 

2225 Executive Circle. PO Box 16000, Colorado Springs. Colorado 80935-6000. 



Name of Field Application Engineer: 
Date of report: 
Originator of report: 

(please Include name, address 
and telephone number) 



Has FAE been informed? 
Is a reply required? 
Originator's reference: 



Product name and number, version number and date (Use special form for TDS): 

Identity of software component with problem: 

Host hardware and OS version: 

Master transputer type and nnemory size; 

Tick one of the following items: 
Documentation error or inadequacy 

Serious software bug (system crashes) 

Other software bug 

Suggestion for design change 

Dsscrrpiion of problem {one problem only) continue on separate sheet if necessary 

(If there is something you cannot do that you expected lo be able to do please describe this) 
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INMOS Software 
LICENCE TERMS AND CONDITIONS 

SINGLE USER - SINGLE CENTRAL PROCESSING UNIT 

IMPORTANT- read terms and conditions before using the software; if your proposed 
use of the software is not compatible with these terms, return It unused ana in its 
origlnai packaging to your supplier who wili arrange for a refund of the price paid. 

This software package and associated manuals ('the Software') is provided by INMOS Limited ('INMOS') either 
directly or via an INMOS distributor anO is licensed by INMOS only upon the following terms and conditions 
which the Licensee will be deemed to have accepted by using the Software. Such terms apply in place of any 
inconsistent provisions contained in INMOS" standard Tern^s and Conditions ot Sale and shall prevail over 
any other terms and conditions whatsoever. 

1 All copyright and other Intellectual property rights in the Software are and shall remain the property 
of INMOS or its licensor absolutely and no title in the same shali pass to Licensee. 

2 Commencing on use of the Software and continuing until any breach of these terms, INMOS hereby 
grants a non-exclusive licence to Licensee for the use of the Software by a single user on a single 
machine. 

3 Copying the Software is not permitted except to the extent necessary to provide Licensee with 
back-up. Any copy made by Licensee must include all copyright and proprietary information notices 
appearing on the copy provided by INMOS or its distributor. 

4 INMOS warrants that it has the right to grant the licence contained in paragraph 2 above. 

5 Provided that Licensee completes and returns to INMOS the accompanying Product Registration 
Form within 14 days of provision of the Software, INMOS will until six months from such provision 
make available to Licensee any updates that are generaEly released by tNMOS to existing licensees 
of the Sottware. 

6 Subject to paragraphs 4 and 5, the Software is transferred to Licensee "AS IS ", "WHERE tS" 
AND ALL CONDITIONS. WARRANTIES AND REPRESENTATIONS EXPRESSED OR IMPLIED BY 
STATUTE, COMMON LAW OR OTHERWISE IN RELATION TO THE SOFTWARE ARE HEREBY 
EXCLUDED (INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY OR 
FITNESS FOR A PARTICULAR PURPOSE). INMOS SHALL NOT BE LIABLE FOR LOSS. DAM- 
AGE OR INJURY, DIRECT OR INDIRECT. FORSEEABLE OR OTHERWISE (INCLUDING LOSS 
OF PROFITS. GOODWILL OR OTHER SPECIAL. INCIDENTAL, CONSEQUENTIAL OR PUNf^ 
TIVE DAMAGES) EVEN IF INMOS HAD BEEN ADVISED OF THE POSSIBILITY OF THE SAME, 
WHETHER CAUSED BY THE NEGLIGENCE OF INMOS OR OTHERWISE EXCEPT LIABILITY 
ARISING FROM THE DUE COURSE OF LAW. 

7 Licensee shali not transfer or assign all or any part of the licence granted herein nor shall Licensee 
grant any sub-licence thereunder without prior written consent of INMOS. 

8 Upon termination of this licence for whatever reason Licensee shall immediately return the Software 
and all copies in his controS or possession to INMOS or its distributor. 
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Worldwide Headquarters 

INMOS Umited 
1000 Aztec West 
Almondsburv 
Bristol eS1 2 4SQ 
UNITED KINGDOM 
TeSepbone (0454)616616 
Fax (0454) 617910 



Worldwide Business Centres 



USA 



EUROPE 



INMOS Business Centre 
Headquarters (USA) 
SGS-THOMSOi^ Microelectronics Inc. 
2325 Executive CircJe 
PC Box leooo 
Colorado Springs 
Colorado S0935-6000 
Telephone (719) 630 4000 
Fax (719) 630 4325 



SGS-THC»/ISON Micraelectrorucs Inc. 

Sales and Mar1<eiing Headquarters {USA] 

1000 East Bell Road 

Phoenix 

Arizona 35022 

Tstephone (602) 867 6100 

Fax (602)667 6102 



INMOS Business Centra 

3GS-THOMSON Mtcroeiectronics Inc 

Lincoln Noftti 

55 Old Bedford Road 

Lincoln 

WasMchusetls 01773 

Telephone (617) 259 0300 

Fax (617) 259 4420 



INMOS BusinssE Centre 

SGS-THOMSON MicroeJoctronics Inc. 

9861 Broken Land Parkway 

Suite 320 

Columbia 

Maryland 21045 

Telephone (301) 995 G9S2 

Fax (301) 290 7047 



INMOS Business 0@n^ 
SGS-THOMSON Mtcroelectronics Inc. 
200 East Saridpointe 
Suite 650 
Santa Ana 
Cajifomia 92707 
Telephone (714) 957 6018 
Fax (714) 957 3281 



INMOS Business Centre 

SGS-THOMSON Microelectronics 3nc. 

2055 Gateway Place 

Suite 300 

San Jose 

Calitornia9&110 

Telephone (40&) 452 91 22 

Fax (408) 452 0216 



INMOS Business Centra 

SGS■THO^flSON MJcroslgctronics Inc. 

1310 Electronics Drive 

Carrollton 

Texas 75006 

Telephone (£14) 466 6844 

Fax (214)466 7352 



ASIA PACIFIC 

Japan 

INMOS Business Centre 

SGS-THOMSON Microelectranics KK. 

Nisseki Takanawa Building, 4ih Roof 

18-10 Takanawa 2 chome 

Minato-ku 

Tokyo 108 

Telephone (03) £80 4125 

Fax (03) 280 4131 

Singapore 

INMOS Business Centre 
SGS-THOMSON MicraelBctronics Pte Ltd. 
26 Ang Ma Kio industrial Park 2 
Singapore £056 
Telephone (65)482 14 11 
Fax (65) 482 02 40 



United Kingdom 

INMOS Business Centre 

SGS-THOMSON Microelectronks Ltd, 

Planar House 

Parkway Globe Parii 

Marlow 

Bucks SL7 1YL 

Telephone (0628) 890 600 

Fax (0628) 630 391 



Franca 

INMOS Business Centre 

SGS-THOMSON Microelearonks SA 

7 avenue Gallieni 

BP 93 

94253 Gentllly Cedex 

Telephone (1)47 40 75 75 

FAX {1)47 40 79 10 



W«*t Germany 

INMOS Business Centre 
SGS-THOMSON Microelectronics GmbH 
Bretonischer Ring 4 
&0U Grdsbrunn 

Telephone (088) 46 00 60 

Fax (069) 46 00 61 40 



Italy 

INMOS Busir^ess Centre 

SGS-THOMSON Micrqeledronics SpA 

V.le Milanoffiri 

Strada4 

Palazzo A/4/A 

20090 Assago (Ml) 

Telephone (2) 89213 1 

Fax (2) 8250449 



